home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_1 / isa_0991.zip / ISAEDIT.ZIP / ISAEDIT.DOC next >
Text File  |  1993-01-14  |  7KB  |  152 lines
  1.  
  2.  
  3.   φ ISA User Editor φ
  4.  
  5.      ■ By Tim Lang (1:153/924)
  6.  
  7. ===============================================================================
  8.  
  9.   *** DISCLAIMER ***
  10.  
  11.    ISAEDIT is only guaranteed to take up space on your Hard Drive.  The authors
  12.    shall be in NO WAY liable for any damage or data loss to your system. In
  13.    other words, it should work, but USE IT AT YOUR OWN RISK!
  14.  
  15.  
  16.   *** OPERATION ***
  17.  
  18.    The file ISAEDIT.EXE is the user editor for ISA.  Only REGISTERED
  19.    users will have full editing rights.  Non-Registered users may only DELETE
  20.    users and change a user's alias.  On top of that they must also suffer
  21.    through a 15 second delay at startup.
  22.  
  23.    I have not put limits on the editor other than the legal maximums of the
  24.    variable.  Please use discretion when editing as OVER-editing WILL cause the
  25.    data file to go corrupt and reck the game.  Recommended maximum settings
  26.    are:  Planets - 25,000
  27.          Money - $1,000,000,000
  28.          Troups - 45,000
  29.  
  30.  
  31.   *** REMOTE OPERATION ***
  32.  
  33.   ISAEDIT works over the modem now.  The only requirement is a DORINFO1.DEF or
  34.   a DOOR.SYS file.  To use ISAEDIT remote, use must call it with one parameter
  35.   The path to the door file :
  36.  
  37.         DORINFOx.DEF - Setup
  38.         ────────────────────
  39.  
  40.         Copy ISAEDIT to the ISA directory and run it with a type 7 or 15
  41.         exit.  Make it run a batch file similar to this:
  42.  
  43.                 cd\bbs\doors\isa
  44.                 isaedit \bbs
  45.                 cd\bbs
  46.                 exit
  47.  
  48.         DOOR.SYS - Setup
  49.         ────────────────
  50.  
  51.         Make the file BBSNAME.DAT in the ISA directory.  The file is one
  52.         line, and the line is your BBS name.  If this file is not found
  53.         ISAEDIT will not work.
  54.  
  55.                 cd\bbs\doors\isa
  56.                 isa \bbs
  57.                 cd\bbs
  58.                 exit
  59.  
  60.   No other parameters are supported.  Calling ISAEDIT with NO parameters will
  61.   run it in local mode.  ISAEDIT has carrier checking, time out checking and
  62.   requires a fossil driver. Basicly, it has the same requirements as
  63.   ISA.
  64.  
  65.   When running ISAEDIT remotly, ALT-S will toggle the user status bar on and
  66.   off.  ISAEDIT also has the same split screen chat as ISA.  Refer the ISA.DOC
  67.   for chat instructions and keys.
  68.  
  69.   If you are running ISAEDIT in your batch file, the errorlevels
  70.   are:  0 - Normal Termination
  71.         2 - Sysop Forced exit
  72.         3 - Inactivity Time Out
  73.         4 - No Carrier
  74.         5 - Time Up
  75.        11 - ISA.DAT not found in current directory
  76.        12 - User record specified not found
  77.        13 - Dorinfo1.def or DOOR.SYS file not found in specified directory
  78.        15 - Error saving User File
  79.  
  80.  
  81. There are probably a few bugs in ISAEDIT still, if one occurs please note
  82. the RUN-TIME ERROR code and address  (ie: RUN-TIME ERROR 100 at 0000:45DF)
  83.  
  84.  
  85. Possible errors in ISA and ISAEDIT:
  86.  
  87. Number Meaning                 With regards to ISA/ISAEDIT
  88. ------ ----------------------- -------------------------------------------
  89.     2  File not found          You are missing a file.
  90.     4  Too many open files     Increase your FILES= statement in your 
  91.                                CONFIG.SYS  We recommend about 25.
  92.     5  File access denied      Either a file has been set to read only, a
  93.                                directory is full, a RENAME tried to rename to
  94.                                an existing file name or a file is not open.
  95.     6  Invalid File Handle     Your file handles have become corrupted, DOS err.
  96.     
  97.   100  Disk Read Error         An attempt was made to read past the end of a 
  98.                    file most often.  Something is corrupted in the
  99.                    record pointers.
  100.   101  Disk Write Error        Generall an indication of a full hard disk.
  101.   103  File Not Open           File is closed when it shouldn't have been.
  102.   104  File Not Open for Input Text file is closed when it shouldn't have been.
  103.   105  File Not Open for Output "   "     "   "       "      "       "
  104.   106  Invalid Numeric Format  Generally this is only caused when reading a
  105.                    BBS interface file (that has the user's info).
  106.                                It happens when ISA is trying to read a
  107.                    numeric value from an interface text file and 
  108.                    there isn't a valid number in the file.
  109.   
  110.   Errors 150 through 162 indicate various HARDWARE failures.  If you're getting
  111.   these, then something is wrong with your PC and I can't be of much help there.
  112.  
  113.     Some commone ones are:
  114.   152  Drive not ready         Controller problem or drive not spinning
  115.   154  CRC error in data       Scrogged disk (real technical eh? (grin))
  116.   156  Disk Seek error            Head problem or bad controller
  117.   157  Unknown media type      Did you just change to DOS 4.0 or 5.0???
  118.   158  Sector not found        Head problem or bad controller
  119.   159  Printer out of paper    This should never happen since ISA doesn't
  120.                                acces the printer
  121.   160  Device write fault      Disk problem
  122.   161  Device read fault       Disk problem
  123.   162  Hardware Failure        "Generic" nasty, nasty problem.
  124.  
  125.   Fatal errors generally indicate a problem that must be fixed before you 
  126.   can continue to run the game.
  127.  
  128.   200  Division by zero        Now I hope you cannot make one of these happen
  129.                    as I check before every division to make sure
  130.                    it DOESN'T happen, but you it might.
  131.   201  Range Check Error       Array index out of range.
  132.   202  Stack Overflow          NOT ENOUGH MEMORY for the stack!  Type either
  133.                                using the swap feature or call ISA from a batch file
  134.   203  Heap overflow error     Same as 202.
  135.   204  Invalid Pointer Op.     Can be caused the same as 202.
  136.   205  Floating point overflow Most likely someone has used the editor
  137.                                and put an insane value in a field somewhere.
  138.                                YOU CANNOT make enough of anything in ISA to
  139.                                cause this with normal play.
  140.   207  Invalid Floating point  You have a real thats trying to be converted to a
  141.        Operation               Long int and its greater than 2 billion.
  142.   209  Overlay File read error ISA had a problem getting an overlay from the
  143.                                ISA.OVR file.  If you're not using EMS, then
  144.                    the .OVR file is missing or is setting on a bad
  145.                    sector on your harddisk.  If you are running EMS
  146.                    then you have a bad memory chip! (yak)
  147.  
  148. Well this covers a large portion of the technical support for ISA.  If you have
  149. further questions, contact James Hargrave (for ISA) or Timothy Lang (for
  150. ISAEDIT).
  151.  
  152.